home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 5 / The 640 Meg Shareware Studio CD-ROM Volume V (Data Express)(1994).ISO / amiga / fdb1_2.lha / FDB / FDB.doc next >
Text File  |  1994-02-10  |  4KB  |  151 lines
  1. Documentation for FDB & UDB                                   10.02.94
  2.  
  3.  
  4. Disclaimer:
  5. -----------
  6.  
  7. These  programs  are freely distributable, but copyrighted by me. This
  8. means you may freely copy it as long as you do not charge more than  a
  9. nominal  fee  for  copying.  These  programs  may  be put on PD disks,
  10. especially on Fred Fish's AmigaLibDisks. If  you  want  to  distribute
  11. this  program  you  MUST  keep this document with it. The programs and
  12. documents must be distributed in their original unmodified form.
  13.  
  14. These programs cannot be used for commercial purposes without  written
  15. permission  by  the author. The author can not be made responsible for
  16. any damage which is caused by using these programs.
  17.  
  18. Send comments, suggestions or bug reports (and gifts ?) to:
  19.  
  20.   Klaus Melchior, Schulstrasse 17
  21.   D-52156 Monschau, Germany
  22.  
  23.   ADSP: kmel@eifel.adsp.sub.org
  24.   DE:   kmel@p2.mowgli.fido.de
  25.   FIDO: 2:242/7.2@fidonet
  26.  
  27.  
  28. Usage:
  29. ------
  30.  
  31. FDB & UDB are based on find/updatedb-utilities from Larry Phillips and
  32. Martin Steppler. If you already have installed them it is easy to  use
  33. my  tools,  because  they  are  compatible.  I  use  the  same kind of
  34. database.
  35.  
  36. UDB generates a database in a  directory  "FINDDB:",  which  you  must
  37. first  assign to some place on your harddisk. It scans all directories
  38. and files specified in the file "FINDDB:<db>.config". This  file  must
  39. contain only one line; pathnames are separated by spaces, e.g.:
  40.  
  41.    FINDDB:find.config  ->  Work: Sys:
  42.    FINDDB:test.config  ->  RAM:
  43.    FINDDB:<db>.config  ->  <path> <path> ...
  44.  
  45. <db>  is  the name of the database.  So you can have several databases
  46. in  your  "FINDDB:",  e.g.   one  of the last Fish-CD, one of all your
  47. Sources, ... . Default of <db> is "find", like Larry's find.
  48.  
  49. FDB finds quickly files/dirs by using these databases.
  50.  
  51.  
  52. Example database:
  53. -----------------
  54.  
  55. FindDB/Aminet.config          12 bytes
  56. FindDB/Aminet.codes       154876 bytes
  57.  
  58.  
  59. CLI-Arguments:
  60. --------------
  61.  
  62. UDB:
  63.  
  64. Paths/M            : paths to scan
  65.                      if no paths specified, <db>.config is used
  66.  
  67. DB=DataBase/K      : specify a database, default is "find"
  68.  
  69.  
  70. FDB:
  71.  
  72. P=Pattern/A        : amiga-pattern, is used between two "#?", so a
  73.                      pattern like "foo" is really "#?foo#?", seen at
  74.                      Larry's find.
  75.  
  76. DB=DataBase/K      : specify a database, default is "find"
  77.  
  78. E=Exact/S          : the pattern is used exactly the way you
  79.                      specified it and is not expanded to #?pattern#?.
  80.  
  81. CS=CaseSensitive/S : the pattern is handled casesensitive
  82.  
  83. D=Dirs/S           : only show directories
  84.  
  85. F=Files/S          : only show files
  86.  
  87. NH=NoHead/S        : no headers are displayed, entries are not sorted
  88.  
  89. NP=NoPath/S        : no absolute pathnames are displayed
  90.  
  91. PG=PAGES/S         : the output is handled in pages,
  92.                      return to continue, other key to break
  93.  
  94.  
  95. Limitations:
  96. ------------
  97.  
  98. UDB:
  99.  
  100. - commandline in "find.config" is limited to 1023 bytes, only on line,
  101.   only one space between paths
  102.  
  103. FDB:
  104.  
  105. - found path is limited to 1023 characters
  106.  
  107.  
  108. ToDo:
  109. -----
  110.  
  111. - ENV-variable "FINDDB" = homepath of config/codes-files
  112. - UDB: softlinks
  113. - FDB: sorted lists
  114. - FDB: MUI-Application
  115.  
  116.  
  117. History:
  118. --------
  119.  
  120.  1.0  12.12.93  * first public release
  121.  
  122.       31.12.93  + fdb: added PAGES mode
  123.  1.1            * private release
  124.  
  125.       07.02.94  + fdb: rewrote find routine in assembler
  126.  
  127.       08.02.94  + fdb: mode "EXACT": parses with "MatchPattern"
  128.                 - fdb: corrected bug, break wasn't recognized at startup
  129.                        (Andreas Harrenberg)
  130.                 - fdb: corrected template & doc, "NH=NoHead"
  131.                        (Gottfried Janik)
  132.                 - fdb: corrected bug, break at mode PAGES was recognized
  133.                        too late
  134.  
  135.       09.02.94  - doc: corrected (Martin Steppler)
  136.                 - udb: corrected bug, break wasn't recognized at startup
  137.                        (Andreas Harrenberg)
  138.  
  139.  1.2  10.02.94  * release
  140.  
  141.  
  142. Thanks to:
  143. ----------
  144.  
  145. - Martin Steppler for testing & doc-corrections
  146. - Stefan Stuntz, Stefan Becker
  147. - Andreas Harrenberg, Gottfried Janik for testing
  148. - OIC / M.Dillon for Dice
  149. - Ibi for special support
  150.  
  151.